<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GtkTipsQuery</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
<link rel="home" href="index.html" title="GTK+ 2 Reference Manual">
<link rel="up" href="DeprecatedObjects.html" title="Deprecated">
<link rel="prev" href="GtkTooltips.html" title="GtkTooltips">
<link rel="next" href="GtkTree.html" title="GtkTree">
<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="GtkTooltips.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="DeprecatedObjects.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GTK+ 2 Reference Manual</th>
<td><a accesskey="n" href="GtkTree.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts">
<a href="#GtkTipsQuery.synopsis" class="shortcut">Top</a>
                   | 
                  <a href="#GtkTipsQuery.description" class="shortcut">Description</a>
                   | 
                  <a href="#GtkTipsQuery.object-hierarchy" class="shortcut">Object Hierarchy</a>
                   | 
                  <a href="#GtkTipsQuery.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
                   | 
                  <a href="#GtkTipsQuery.properties" class="shortcut">Properties</a>
                   | 
                  <a href="#GtkTipsQuery.signals" class="shortcut">Signals</a>
</td></tr>
</table>
<div class="refentry">
<a name="GtkTipsQuery"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="GtkTipsQuery.top_of_page"></a>GtkTipsQuery</span></h2>
<p>GtkTipsQuery — Displays help about widgets in the user interface</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<a name="GtkTipsQuery.synopsis"></a><h2>Synopsis</h2>
<pre class="synopsis">
#include &lt;gtk/gtk.h&gt;

struct              <a class="link" href="GtkTipsQuery.html#GtkTipsQuery-struct" title="struct GtkTipsQuery">GtkTipsQuery</a>;
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkTipsQuery.html#gtk-tips-query-new" title="gtk_tips_query_new ()">gtk_tips_query_new</a>                  (<em class="parameter"><code><span class="type">void</span></code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkTipsQuery.html#gtk-tips-query-start-query" title="gtk_tips_query_start_query ()">gtk_tips_query_start_query</a>          (<em class="parameter"><code><a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a> *tips_query</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkTipsQuery.html#gtk-tips-query-stop-query" title="gtk_tips_query_stop_query ()">gtk_tips_query_stop_query</a>           (<em class="parameter"><code><a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a> *tips_query</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkTipsQuery.html#gtk-tips-query-set-caller" title="gtk_tips_query_set_caller ()">gtk_tips_query_set_caller</a>           (<em class="parameter"><code><a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a> *tips_query</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *caller</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkTipsQuery.html#gtk-tips-query-set-labels" title="gtk_tips_query_set_labels ()">gtk_tips_query_set_labels</a>           (<em class="parameter"><code><a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a> *tips_query</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label_inactive</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label_no_tip</code></em>);
</pre>
</div>
<div class="refsect1">
<a name="GtkTipsQuery.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="synopsis">
  <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
   +----<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
         +----<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a>
               +----<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
                     +----<a class="link" href="GtkMisc.html" title="GtkMisc">GtkMisc</a>
                           +----<a class="link" href="GtkLabel.html" title="GtkLabel">GtkLabel</a>
                                 +----GtkTipsQuery
</pre>
</div>
<div class="refsect1">
<a name="GtkTipsQuery.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
<p>
GtkTipsQuery implements
 AtkImplementorIface and  <a class="link" href="GtkBuildable.html" title="GtkBuildable">GtkBuildable</a>.</p>
</div>
<div class="refsect1">
<a name="GtkTipsQuery.properties"></a><h2>Properties</h2>
<pre class="synopsis">
  "<a class="link" href="GtkTipsQuery.html#GtkTipsQuery--caller" title='The "caller" property'>caller</a>"                   <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>*            : Read / Write
  "<a class="link" href="GtkTipsQuery.html#GtkTipsQuery--emit-always" title='The "emit-always" property'>emit-always</a>"              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
  "<a class="link" href="GtkTipsQuery.html#GtkTipsQuery--label-inactive" title='The "label-inactive" property'>label-inactive</a>"           <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write
  "<a class="link" href="GtkTipsQuery.html#GtkTipsQuery--label-no-tip" title='The "label-no-tip" property'>label-no-tip</a>"             <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write
</pre>
</div>
<div class="refsect1">
<a name="GtkTipsQuery.signals"></a><h2>Signals</h2>
<pre class="synopsis">
  "<a class="link" href="GtkTipsQuery.html#GtkTipsQuery-start-query" title='The "start-query" signal'>start-query</a>"                                    : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a>
  "<a class="link" href="GtkTipsQuery.html#GtkTipsQuery-stop-query" title='The "stop-query" signal'>stop-query</a>"                                     : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a>
  "<a class="link" href="GtkTipsQuery.html#GtkTipsQuery-widget-entered" title='The "widget-entered" signal'>widget-entered</a>"                                 : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
  "<a class="link" href="GtkTipsQuery.html#GtkTipsQuery-widget-selected" title='The "widget-selected" signal'>widget-selected</a>"                                : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
</pre>
</div>
<div class="refsect1">
<a name="GtkTipsQuery.description"></a><h2>Description</h2>
<p>
The <a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a> widget is a subclass of <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> which is used to display
help about widgets in a user interface.
</p>
<p>
A query is started with a call to <a class="link" href="GtkTipsQuery.html#gtk-tips-query-start-query" title="gtk_tips_query_start_query ()"><code class="function">gtk_tips_query_start_query()</code></a>, usually
when some kind of 'Help' button is pressed. The <a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a> then grabs all
events, stopping the user interface from functioning normally.
Then as the user moves the mouse over the widgets, the <a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a> displays
each widget's tooltip text.
</p>
<p>
By connecting to the "widget-entered" or "widget-selected" signals, it is
possible to customize the <a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a> to perform other actions when widgets
are entered or selected. For example, a help browser could be opened with
documentation on the widget selected.
</p>
<p>
At some point a call to <a class="link" href="GtkTipsQuery.html#gtk-tips-query-stop-query" title="gtk_tips_query_stop_query ()"><code class="function">gtk_tips_query_stop_query()</code></a> must be made in order to
stop the query and return the interface to its normal state.
The <a class="link" href="GtkTipsQuery.html#gtk-tips-query-set-caller" title="gtk_tips_query_set_caller ()"><code class="function">gtk_tips_query_set_caller()</code></a> function can be used to specify a widget
which the user can select to stop the query (often the same button used to
start the query).
</p>
</div>
<div class="refsect1">
<a name="GtkTipsQuery.details"></a><h2>Details</h2>
<div class="refsect2">
<a name="GtkTipsQuery-struct"></a><h3>struct GtkTipsQuery</h3>
<pre class="programlisting">struct GtkTipsQuery;</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GtkTipsQuery</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
The <a class="link" href="GtkTipsQuery.html#GtkTipsQuery-struct" title="struct GtkTipsQuery"><span class="type">GtkTipsQuery</span></a> struct contains private data only, and
should be accessed using the functions below.
</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-tips-query-new"></a><h3>gtk_tips_query_new ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_tips_query_new                  (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_tips_query_new</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Creates a new <a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>a new <a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a>.</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-tips-query-start-query"></a><h3>gtk_tips_query_start_query ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_tips_query_start_query          (<em class="parameter"><code><a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a> *tips_query</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_tips_query_start_query</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Starts a query.
The <a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a> widget will take control of the mouse and as the mouse
moves it will display the tooltip of the widget beneath the mouse.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>tips_query</code></em> :</span></p></td>
<td>a <a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a>.</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-tips-query-stop-query"></a><h3>gtk_tips_query_stop_query ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_tips_query_stop_query           (<em class="parameter"><code><a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a> *tips_query</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_tips_query_stop_query</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Stops a query.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>tips_query</code></em> :</span></p></td>
<td>a <a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a>.</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-tips-query-set-caller"></a><h3>gtk_tips_query_set_caller ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_tips_query_set_caller           (<em class="parameter"><code><a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a> *tips_query</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *caller</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_tips_query_set_caller</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Sets the widget which initiates the query, usually a button.
If the <em class="parameter"><code>caller</code></em> is selected while the query is running, the query is
automatically stopped.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>tips_query</code></em> :</span></p></td>
<td>a <a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>caller</code></em> :</span></p></td>
<td>the widget which initiates the query.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-tips-query-set-labels"></a><h3>gtk_tips_query_set_labels ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_tips_query_set_labels           (<em class="parameter"><code><a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a> *tips_query</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label_inactive</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label_no_tip</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_tips_query_set_labels</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Sets the text to display when the query is not in effect,
and the text to display when the query is in effect but the widget beneath
the pointer has no tooltip.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>tips_query</code></em> :</span></p></td>
<td>a <a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>label_inactive</code></em> :</span></p></td>
<td>the text to display when the query is not running.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>label_no_tip</code></em> :</span></p></td>
<td>the text to display when the query is running but the widget
beneath the pointer has no tooltip.</td>
</tr>
</tbody>
</table></div>
</div>
</div>
<div class="refsect1">
<a name="GtkTipsQuery.property-details"></a><h2>Property Details</h2>
<div class="refsect2">
<a name="GtkTipsQuery--caller"></a><h3>The <code class="literal">"caller"</code> property</h3>
<pre class="programlisting">  "caller"                   <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>*            : Read / Write</pre>
<p>
The widget that starts the tips query, usually a button.
If it is selected while the query is in effect the query is automatically
stopped.
</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkTipsQuery--emit-always"></a><h3>The <code class="literal">"emit-always"</code> property</h3>
<pre class="programlisting">  "emit-always"              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
<p>
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the widget-entered and widget-selected signals are emitted even when
the widget has no tooltip set.
</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkTipsQuery--label-inactive"></a><h3>The <code class="literal">"label-inactive"</code> property</h3>
<pre class="programlisting">  "label-inactive"           <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write</pre>
<p>
The text to display in the <a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a> widget when the query is not in
effect.
</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkTipsQuery--label-no-tip"></a><h3>The <code class="literal">"label-no-tip"</code> property</h3>
<pre class="programlisting">  "label-no-tip"             <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write</pre>
<p>
The text to display in the <a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a> widget when the query is running
and the widget that the pointer is over has no tooltip.
</p>
<p>Default value: NULL</p>
</div>
</div>
<div class="refsect1">
<a name="GtkTipsQuery.signal-details"></a><h2>Signal Details</h2>
<div class="refsect2">
<a name="GtkTipsQuery-start-query"></a><h3>The <code class="literal">"start-query"</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a> *tipsquery,
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>      user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a></pre>
<p>
Emitted when the query is started.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>tipsquery</code></em> :</span></p></td>
<td>the object which received the signal.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="GtkTipsQuery-stop-query"></a><h3>The <code class="literal">"stop-query"</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a> *tipsquery,
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>      user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a></pre>
<p>
Emitted when the query is stopped.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>tipsquery</code></em> :</span></p></td>
<td>the object which received the signal.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="GtkTipsQuery-widget-entered"></a><h3>The <code class="literal">"widget-entered"</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a> *tipsquery,
                                                        <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>    *widget,
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>        *arg1,
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>        *arg2,
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>      user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
<p>
Emitted when a widget is entered by the pointer while the query is in effect.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>tipsquery</code></em> :</span></p></td>
<td>the object which received the signal.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td>
<td>the widget that was entered by the pointer.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>tip_text</code></em> :</span></p></td>
<td>the widget's tooltip.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>tip_private</code></em> :</span></p></td>
<td>the widget's private tooltip (see <a class="link" href="GtkTooltips.html#gtk-tooltips-set-tip" title="gtk_tooltips_set_tip ()"><code class="function">gtk_tooltips_set_tip()</code></a>).</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="GtkTipsQuery-widget-selected"></a><h3>The <code class="literal">"widget-selected"</code> signal</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            user_function                      (<a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a> *tipsquery,
                                                        <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>    *widget,
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>        *arg1,
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>        *arg2,
                                                        <a href="../gdk/gdk-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a>     *arg3,
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>      user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
<p>
Emitted when a widget is selected during a query.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>tipsquery</code></em> :</span></p></td>
<td>the object which received the signal.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td>
<td>the widget that was selected.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>tip_text</code></em> :</span></p></td>
<td>the widget's tooltip.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>tip_private</code></em> :</span></p></td>
<td>the widget's private tooltip (see <a class="link" href="GtkTooltips.html#gtk-tooltips-set-tip" title="gtk_tooltips_set_tip ()"><code class="function">gtk_tooltips_set_tip()</code></a>).</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td>
<td>the button press or button release event.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the query should be stopped.</td>
</tr>
</tbody>
</table></div>
</div>
</div>
<div class="refsect1">
<a name="GtkTipsQuery.see-also"></a><h2>See Also</h2>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><a class="link" href="GtkTooltips.html" title="GtkTooltips"><span class="type">GtkTooltips</span></a></span></p></td>
<td><p>the object which handles tooltips.</p></td>
</tr></tbody>
</table></div>
<p>
</p>
</div>
</div>
<div class="footer">
<hr>
          Generated by GTK-Doc V1.18</div>
</body>
</html>